Kanzi 3.9.10
kanzi::GlRenderState Class Reference

OpenGL render state. More...

#include <kanzi/core.ui/platform/graphics_backend/gl/gl_render_state.hpp>

Classes

class  RenderValueInfo
 Render value information. More...
 
union  RenderValueUnion
 Union containing one render value to be arranged into an array. More...
 
struct  TextureRenderValue
 Container for texture render value and the width/height uniforms. More...
 

Public Types

using HandleType
 Type for handle identifiers into values in the render state.
 

Public Member Functions

void attach (MaterialSharedPtr material)
 Attach to a certain material/node combination.
 
bool bind (Renderer &renderer)
 Applies the render state the render state.
 
template<typename T >
void fillDefaultValues (GlRenderState::HandleType handle, size_t startIndex, size_t endIndex)
 Fills a uniform array with default values.
 
optional< intgetBlendModeValue () const
 Get blend mode value.
 
template<typename T >
size_t getElementCount (GlRenderState::HandleType handle) const
 Gets the number of elements for given handle.
 
template<>
size_t getElementCount (GlRenderState::HandleType handle) const
 GlRenderState::getElementCount() specialization.
 
template<typename T >
HandleType getHandle (string_view name)
 Access handle by type.
 
template<>
GlRenderState::HandleType getHandle (string_view name)
 GlRenderState::getHandle() specialization.
 
MaterialSharedPtr getMaterial () const
 Gets the attached material.
 
template<>
TextureSharedPtr getValue (GlRenderState::HandleType handle) const
 GlRenderState::getValue() specialization.
 
template<typename T >
T getValue (HandleType handle) const
 Accesses a value by handle.
 
template<typename T >
T getValue (HandleType handle, size_t index) const
 Accesses a value by handle.
 
 GlRenderState ()
 Empty constructor.
 
template<>
bool handleMatches (GlRenderState::HandleType handle, string_view name) const
 GlRenderState::handleMatches() specialization.
 
template<typename T >
bool handleMatches (HandleType handle, string_view name) const
 Checks whether given handle matches the current render state.
 
bool hasMaterial () const
 Returns whether the render state has a valid material.
 
void reattach ()
 Reattach already-attached material.
 
void setBlendModeValue (optional< int > value)
 Sets the blend mode value.
 
template<typename T >
bool setRange (GlRenderState::HandleType handle, AbstractRange &range)
 Specialized implementation for assigning range.
 
template<>
bool setRange (GlRenderState::HandleType, AbstractRange &)
 GlRenderState::setRange() specialization.
 
template<>
bool setRange (GlRenderState::HandleType, AbstractRange &)
 GlRenderState::setRange() specialization.
 
template<>
bool setRange (GlRenderState::HandleType, AbstractRange &)
 GlRenderState::setRange() specialization.
 
template<>
bool setRange (GlRenderState::HandleType, AbstractRange &)
 GlRenderState::setRange() specialization.
 
bool setRange (HandleType handle, AbstractRange &range)
 Sets values of a render target array from a range.
 
bool setRange (HandleType handle, AbstractRange *range)
 Sets values of a render target array from a range.
 
bool setRange (HandleType handle, const AbstractRangeSharedPtr &range)
 Sets values of a render target array from a range.
 
template<typename T >
bool setTypedValue (GlRenderState::HandleType handle, const Variant &value, size_t elementIndex)
 Sets a variant value.
 
template<typename T >
void setValue (HandleType handle, const T &value)
 Wrapper for setting a render value by handle.
 
template<typename T >
void setValue (HandleType handle, const T &value, size_t elementIndex)
 Set a render value identified by handle.
 

Protected Types

typedef vector< RenderValueInfoRenderValueInfoContainer
 Container for render value information.
 
typedef vector< RenderValueUnionRenderValueUnionContainer
 Container for render values.
 
typedef vector< TextureRenderValueTextureRenderValueContainer
 Container for texture render values.
 

Protected Member Functions

int acquireUniformLocation (AbstractPropertyType propertyType) const
 Acquires uniform location wrapper.
 
int acquireUniformLocation (string_view name) const
 Acquires uniform location from the attached material.
 
size_t allocateValues (size_t count)
 Allocates values from value array.
 
HandleType getHandle (PropertyDataType type, string_view name, size_t count)
 Accesses a handle by explicit information.
 
size_t getUniformElementCount (AbstractPropertyType propertyType) const
 Get uniform element count wrapper.
 
size_t getUniformElementCount (string_view name) const
 Gets the number of uniform elements in the attached material.
 
floatgetValueArrayFloat (HandleType handle, size_t elementIndex)
 Gets a reference into the value array (as floats).
 
intgetValueArrayInt (HandleType handle, size_t elementIndex)
 Gets a reference into the value array (as integers).
 
void setTypedValue (HandleType handle, bool value, size_t elementIndex)
 Specialization for setting a value of specific type.
 
void setTypedValue (HandleType handle, ColorRGBA value, size_t elementIndex)
 Specialization for setting a value of specific type.
 
void setTypedValue (HandleType handle, const Matrix3x3 &value, size_t elementIndex)
 Specialization for setting a value of specific type.
 
void setTypedValue (HandleType handle, const Matrix4x4 &value, size_t elementIndex)
 Specialization for setting a value of specific type.
 
void setTypedValue (HandleType handle, const SRTValue2D &value, size_t elementIndex)
 Specialization for setting a value of specific type.
 
void setTypedValue (HandleType handle, const SRTValue3D &value, size_t elementIndex)
 Specialization for setting a value of specific type.
 
void setTypedValue (HandleType handle, float value, size_t elementIndex)
 Specialization for setting a value of specific type.
 
void setTypedValue (HandleType handle, int value, size_t elementIndex)
 Specialization for setting a value of specific type.
 
void setTypedValue (HandleType handle, TextureSharedPtr value, size_t elementIndex)
 Specialization for setting a value of specific type.
 
void setTypedValue (HandleType handle, Vector2 value, size_t elementIndex)
 Specialization for setting a value of specific type.
 
void setTypedValue (HandleType handle, Vector3 value, size_t elementIndex)
 Specialization for setting a value of specific type.
 
void setTypedValue (HandleType handle, Vector4 value, size_t elementIndex)
 Specialization for setting a value of specific type.
 
void setTypedValue (HandleType handle, void *value, size_t elementIndex)
 Specialization for setting a value of specific type.
 

Static Protected Member Functions

template<typename T >
static size_t getValueSize ()
 Gets the size of a render value type.
 
template<>
size_t getValueSize ()
 GlRenderState::getValueSize() specialization.
 
template<>
size_t getValueSize ()
 GlRenderState::getValueSize() specialization.
 
template<typename T >
static PropertyDataType getValueType ()
 Gets the property type of a render value type.
 

Protected Attributes

optional< intm_blendModeValue
 Singular property value for blend mode.
 
RenderValueInfoContainer m_infoArray
 Render value information structures.
 
MaterialSharedPtr m_material
 Currently attached material.
 
TextureRenderValueContainer m_textureArray
 Render texture values, contain textures within the array.
 
vector< RenderValueUnionm_valueArray
 Render value unions.
 

Detailed Description

OpenGL render state.

Member Typedef Documentation

◆ HandleType

Type for handle identifiers into values in the render state.

◆ RenderValueInfoContainer

Container for render value information.

◆ RenderValueUnionContainer

Container for render values.

◆ TextureRenderValueContainer

Container for texture render values.

Constructor & Destructor Documentation

◆ GlRenderState()

kanzi::GlRenderState::GlRenderState ( )
inlineexplicit

Empty constructor.

Member Function Documentation

◆ bind()

bool kanzi::GlRenderState::bind ( Renderer & renderer)

Applies the render state the render state.

After calling this function, geometry can be rendered using the render state settings.

Parameters
rendererRenderer to use.
Returns
If the shader program was available and bound, true, otherwise false.

◆ attach()

void kanzi::GlRenderState::attach ( MaterialSharedPtr material)

Attach to a certain material/node combination.

Parameters
materialMaterial to attach to.

◆ reattach()

void kanzi::GlRenderState::reattach ( )

Reattach already-attached material.

Does nothing if no material attached.

◆ getMaterial()

MaterialSharedPtr kanzi::GlRenderState::getMaterial ( ) const
inline

Gets the attached material.

Returns
Shared pointer to material.

◆ hasMaterial()

bool kanzi::GlRenderState::hasMaterial ( ) const
inline

Returns whether the render state has a valid material.

Returns
If a valid material is attached, true, otherwise false.

◆ setValue() [1/2]

template<typename T >
void kanzi::GlRenderState::setValue ( HandleType handle,
const T & value,
size_t elementIndex )
inline

Set a render value identified by handle.

The handle may be invalid (negative), in which case this function does nothing.

Parameters
handleIdentifying handle.
valueValue to set.
elementIndexIndex of the element in the value to set.

◆ setValue() [2/2]

template<typename T >
void kanzi::GlRenderState::setValue ( HandleType handle,
const T & value )
inline

Wrapper for setting a render value by handle.

Element index is zero.

Parameters
handleIdentifying handle.
valueValue to set.

◆ getBlendModeValue()

optional< int > kanzi::GlRenderState::getBlendModeValue ( ) const
inline

Get blend mode value.

Returns
Optional blend mode value.
Since
Kanzi 3.9.1 return data type changed from optional<GraphicsBlendMode> to optional<int>.

◆ setBlendModeValue()

void kanzi::GlRenderState::setBlendModeValue ( optional< int > value)
inline

Sets the blend mode value.

Parameters
valueOptional blend mode value.
Since
Kanzi 3.9.1 data type of value parameter changed from GraphicsBlendMode to optional<int>.

◆ getHandle() [1/3]

template<typename T >
HandleType kanzi::GlRenderState::getHandle ( string_view name)
inline

Access handle by type.

Parameters
nameValue name.
Returns
Handle (index) to info array.

◆ getElementCount() [1/2]

template<typename T >
size_t kanzi::GlRenderState::getElementCount ( GlRenderState::HandleType handle) const
inline

Gets the number of elements for given handle.

Parameters
handleHandle.
Returns
Number of elements for the handle.

◆ getValue() [1/3]

template<typename T >
T kanzi::GlRenderState::getValue ( HandleType handle,
size_t index ) const
inline

Accesses a value by handle.

Handle must be valid, access with invalid handle is undefined behavior.

Parameters
handleHandle to value.
indexIndex of the value to access.
Returns
Value previously stored with the handle.

◆ getValue() [2/3]

template<typename T >
T kanzi::GlRenderState::getValue ( HandleType handle) const
inline

Accesses a value by handle.

Index of the accessed value is zero.

Parameters
handleHandle to value.
Returns
Value previously stored with the handle.

◆ handleMatches() [1/2]

template<typename T >
bool kanzi::GlRenderState::handleMatches ( HandleType handle,
string_view name ) const
inline

Checks whether given handle matches the current render state.

Parameters
handleHandle to check.
nameName to compare against.
Returns
True if given handle and name match in the render state, false otherwise.

◆ setTypedValue() [1/14]

template<typename T >
bool kanzi::GlRenderState::setTypedValue ( GlRenderState::HandleType handle,
const Variant & value,
size_t elementIndex )
inline

Sets a variant value.

If the value is not an exact match, tries to cast the value to T.

Parameters
handleThe identifying handle.
valueThe variant value.
elementIndexThe index of the array element.
Returns
If setting the value succeeds, true, otherwise false.
Since
Kanzi 3.9.6

◆ fillDefaultValues()

template<typename T >
void kanzi::GlRenderState::fillDefaultValues ( GlRenderState::HandleType handle,
size_t startIndex,
size_t endIndex )
inline

Fills a uniform array with default values.

Parameters
handleThe identifying handle.
startIndexThe start index for the fill operation.
endIndexThe end index pointing to one after the last fill element.
Since
Kanzi 3.9.6.

◆ setRange() [1/8]

template<typename T >
bool kanzi::GlRenderState::setRange ( GlRenderState::HandleType handle,
AbstractRange & range )
inline

Specialized implementation for assigning range.

If the array is larger than the range, writes default values to the remaining values in the end of the array. You must validate the handle before calling this function.

Parameters
handleValid handle from the render state.
rangeRange input.
Returns
If setting the value succeeds, true, otherwise false.
Since
Kanzi 3.9.6

◆ setRange() [2/8]

bool kanzi::GlRenderState::setRange ( HandleType handle,
AbstractRange & range )

Sets values of a render target array from a range.

If the array is larger than the range, writes default values to the remaining values in the end of the array.

Parameters
handleHandle from the render state.
rangeRange input.
Returns
If setting the value succeeds, true, otherwise false.
Since
Kanzi 3.9.0
Kanzi 3.9.6 changed the type of the range parameter.

◆ setRange() [3/8]

bool kanzi::GlRenderState::setRange ( HandleType handle,
AbstractRange * range )

Sets values of a render target array from a range.

If the array is larger than the range, writes default values to the remaining values in the end of the array. If the range is a nullptr, sets all the elements of the render target array to default values.

Parameters
handleHandle from the render state.
rangeRange input.
Returns
If value was successfully set, true, otherwise false.
Since
Kanzi 3.9.0

◆ setRange() [4/8]

bool kanzi::GlRenderState::setRange ( HandleType handle,
const AbstractRangeSharedPtr & range )
inline

Sets values of a render target array from a range.

If the array is larger than the range, writes default values to the remaining values in the end of the array. If the range is a nullptr, sets all the elements of the render target array to default values.

Parameters
handleHandle from the render state.
rangeRange input.
Returns
If value was successfully set, true, otherwise false.
Since
Kanzi 3.9.0

◆ acquireUniformLocation() [1/2]

int kanzi::GlRenderState::acquireUniformLocation ( string_view name) const
protected

Acquires uniform location from the attached material.

Parameters
nameName to query.
Returns
Uniform location integer or -1 if not valid.

◆ acquireUniformLocation() [2/2]

int kanzi::GlRenderState::acquireUniformLocation ( AbstractPropertyType propertyType) const
inlineprotected

Acquires uniform location wrapper.

Parameters
propertyTypeProperty type to query.
Returns
Uniform location integer or -1 if not valid.

◆ getUniformElementCount() [1/2]

size_t kanzi::GlRenderState::getUniformElementCount ( string_view name) const
protected

Gets the number of uniform elements in the attached material.

Parameters
nameName to query.
Returns
Number of elements in the uniform or 0 if not valid.
Since
Kanzi 3.9.7 changed the type of the return value to size_t.

◆ getUniformElementCount() [2/2]

size_t kanzi::GlRenderState::getUniformElementCount ( AbstractPropertyType propertyType) const
inlineprotected

Get uniform element count wrapper.

Parameters
propertyTypeProperty type to query.
Returns
Number of elements in the uniform or 0 if not valid.
Since
Kanzi 3.9.7 changed the type of the return value to size_t.

◆ allocateValues()

size_t kanzi::GlRenderState::allocateValues ( size_t count)
inlineprotected

Allocates values from value array.

Parameters
countNumber of values to allocate.
Returns
Starting index where values should be written.

◆ getHandle() [2/3]

HandleType kanzi::GlRenderState::getHandle ( PropertyDataType type,
string_view name,
size_t count )
inlineprotected

Accesses a handle by explicit information.

Parameters
typeValue type.
nameValue name.
countNumber of values to allocate per element if new handle is required.
Returns
Handle (index) to info array.

◆ getValueArrayInt()

int * kanzi::GlRenderState::getValueArrayInt ( HandleType handle,
size_t elementIndex )
inlineprotected

Gets a reference into the value array (as integers).

Contents of the value are not guaranteed, it points directly to the memory block within a value array.

Parameters
handleHandle to value info.
elementIndexIndex of the element for the render value, used only for error checking.
Returns
Pointer to value array as integer in given point.

◆ getValueArrayFloat()

float * kanzi::GlRenderState::getValueArrayFloat ( HandleType handle,
size_t elementIndex )
inlineprotected

Gets a reference into the value array (as floats).

Contents of the value are not guaranteed, it's pointing directly to the memory block within value array.

Parameters
handleHandle to value info.
elementIndexIndex of the element for the render value, used only for error checking.
Returns
Pointer to value array as float in given point.

◆ setTypedValue() [2/14]

void kanzi::GlRenderState::setTypedValue ( HandleType handle,
bool value,
size_t elementIndex )
inlineprotected

Specialization for setting a value of specific type.

Parameters
handleName.
valueValue.
elementIndexIndex of the element to set.

◆ setTypedValue() [3/14]

void kanzi::GlRenderState::setTypedValue ( HandleType handle,
int value,
size_t elementIndex )
inlineprotected

Specialization for setting a value of specific type.

Parameters
handleName.
valueValue.
elementIndexIndex of the element to set.

◆ setTypedValue() [4/14]

void kanzi::GlRenderState::setTypedValue ( HandleType handle,
float value,
size_t elementIndex )
inlineprotected

Specialization for setting a value of specific type.

Parameters
handleName.
valueValue.
elementIndexIndex of the element to set.

◆ setTypedValue() [5/14]

void kanzi::GlRenderState::setTypedValue ( HandleType handle,
ColorRGBA value,
size_t elementIndex )
inlineprotected

Specialization for setting a value of specific type.

Parameters
handleName.
valueValue.
elementIndexIndex of the element to set.

◆ setTypedValue() [6/14]

void kanzi::GlRenderState::setTypedValue ( HandleType handle,
Vector2 value,
size_t elementIndex )
inlineprotected

Specialization for setting a value of specific type.

Parameters
handleName.
valueValue.
elementIndexIndex of the element to set.

◆ setTypedValue() [7/14]

void kanzi::GlRenderState::setTypedValue ( HandleType handle,
Vector3 value,
size_t elementIndex )
inlineprotected

Specialization for setting a value of specific type.

Parameters
handleName.
valueValue.
elementIndexIndex of the element to set.

◆ setTypedValue() [8/14]

void kanzi::GlRenderState::setTypedValue ( HandleType handle,
Vector4 value,
size_t elementIndex )
inlineprotected

Specialization for setting a value of specific type.

Parameters
handleName.
valueValue.
elementIndexIndex of the element to set.

◆ setTypedValue() [9/14]

void kanzi::GlRenderState::setTypedValue ( HandleType handle,
const Matrix3x3 & value,
size_t elementIndex )
inlineprotected

Specialization for setting a value of specific type.

Parameters
handleName.
valueValue.
elementIndexIndex of the element to set.

◆ setTypedValue() [10/14]

void kanzi::GlRenderState::setTypedValue ( HandleType handle,
const Matrix4x4 & value,
size_t elementIndex )
inlineprotected

Specialization for setting a value of specific type.

Parameters
handleName.
valueValue.
elementIndexIndex of the element to set.

◆ setTypedValue() [11/14]

void kanzi::GlRenderState::setTypedValue ( HandleType handle,
const SRTValue2D & value,
size_t elementIndex )
inlineprotected

Specialization for setting a value of specific type.

Parameters
handleName.
valueValue.
elementIndexIndex of the element to set.

◆ setTypedValue() [12/14]

void kanzi::GlRenderState::setTypedValue ( HandleType handle,
const SRTValue3D & value,
size_t elementIndex )
inlineprotected

Specialization for setting a value of specific type.

Parameters
handleName.
valueValue.
elementIndexIndex of the element to set.

◆ setTypedValue() [13/14]

void kanzi::GlRenderState::setTypedValue ( HandleType handle,
void * value,
size_t elementIndex )
inlineprotected

Specialization for setting a value of specific type.

This version intentionally exists to throw an exception on an invalid call.

Parameters
handleName.
valueValue.
elementIndexIndex of the element to set.

◆ setTypedValue() [14/14]

void kanzi::GlRenderState::setTypedValue ( HandleType handle,
TextureSharedPtr value,
size_t elementIndex )
protected

Specialization for setting a value of specific type.

Parameters
handleName.
valueValue.
elementIndexIndex of the element to set.
Returns
Handle.

◆ getValueSize() [1/3]

template<typename T >
static size_t kanzi::GlRenderState::getValueSize ( )
inlinestaticprotected

Gets the size of a render value type.

Returns
Number of values type requires.

◆ getValueType()

template<typename T >
static PropertyDataType kanzi::GlRenderState::getValueType ( )
inlinestaticprotected

Gets the property type of a render value type.

Returns
Number of values type requires.

◆ getHandle() [3/3]

template<>
GlRenderState::HandleType kanzi::GlRenderState::getHandle ( string_view name)

GlRenderState::getHandle() specialization.

◆ handleMatches() [2/2]

template<>
bool kanzi::GlRenderState::handleMatches ( GlRenderState::HandleType handle,
string_view name ) const

◆ getValue() [3/3]

template<>
TextureSharedPtr kanzi::GlRenderState::getValue ( GlRenderState::HandleType handle) const

GlRenderState::getValue() specialization.

◆ getElementCount() [2/2]

template<>
size_t kanzi::GlRenderState::getElementCount ( GlRenderState::HandleType handle) const

◆ getValueSize() [2/3]

template<>
size_t kanzi::GlRenderState::getValueSize ( )
staticprotected

◆ getValueSize() [3/3]

template<>
size_t kanzi::GlRenderState::getValueSize ( )
staticprotected

◆ setRange() [5/8]

template<>
bool kanzi::GlRenderState::setRange ( GlRenderState::HandleType ,
AbstractRange &  )

GlRenderState::setRange() specialization.

◆ setRange() [6/8]

template<>
bool kanzi::GlRenderState::setRange ( GlRenderState::HandleType ,
AbstractRange &  )

GlRenderState::setRange() specialization.

◆ setRange() [7/8]

template<>
bool kanzi::GlRenderState::setRange ( GlRenderState::HandleType ,
AbstractRange &  )

GlRenderState::setRange() specialization.

◆ setRange() [8/8]

template<>
bool kanzi::GlRenderState::setRange ( GlRenderState::HandleType ,
AbstractRange &  )

GlRenderState::setRange() specialization.

Member Data Documentation

◆ m_blendModeValue

optional<int> kanzi::GlRenderState::m_blendModeValue
protected

Singular property value for blend mode.

Since
Kanzi 3.9.1 data type changed from optional<GraphicsBlendMode> to optional<int>.

◆ m_infoArray

RenderValueInfoContainer kanzi::GlRenderState::m_infoArray
protected

Render value information structures.

◆ m_valueArray

vector<RenderValueUnion> kanzi::GlRenderState::m_valueArray
protected

Render value unions.

Pointed to by non-texture elements in the render value information array.

◆ m_textureArray

TextureRenderValueContainer kanzi::GlRenderState::m_textureArray
protected

Render texture values, contain textures within the array.

◆ m_material

MaterialSharedPtr kanzi::GlRenderState::m_material
protected

Currently attached material.


The documentation for this class was generated from the following file: